动作

每个 Zap 都从一个单一的触发器开始，该触发器监视新数据或更新数据，从而启动用户的流程。随后，动作步骤会利用这些数据。

Zapier 动作通过 API 调用在您的应用中创建或更新单个项目，这些调用包含用户自定义的多个输入字段的详细信息。

Zaps 可以包含一个或多个动作。

有两种类型的动作可供选择。

1. 创建动作

大多数 Zapier 集成至少应包括创建动作，以让用户能够自动向其应用添加项目。在构建您的应用时，可以参考此处列出的常见动作（按应用类别划分）以获取灵感。

在 Zaps 中，创建动作可以创建应用中的新项目或更新现有项目。返回的输出应是一个对象，包含各个字段，这些字段将被解析并映射到后续 Zap 步骤中。

创建动作的返回输出应是一个对象，包含关于已创建项目的各个字段，例如 ID、新项目的详细信息（如果可能包括链接），以及关于该记录的任何其他有用数据。请不要仅返回一个“成功”消息。

如果动作失败，应返回 4xx 错误。如果您的 API 返回 2xx 错误，请在 API 调用中添加自定义代码，将其替换为适当的错误代码。

更新动作应与创建动作分开处理。

如果需要，动作可以使用相同的数据创建多个项目，不过您可能需要自定义 API 调用代码来实现一次性创建多个项目。只在处理链接项目时这样做，例如，如果一个应用将客户和客户地址分开存储。如果需要创建的多个项目是您应用中的顶级复杂项目，则应在 Zapier 中将它们作为单独的动作。然后，您可以使用下拉菜单链接这些动作，让用户选择配对项目、添加一个搜索动作以查找特定项目，并让用户使用 Zapier 中的“使用自定义值”选项来匹配项目。

2. 搜索动作

搜索动作在应用中查找现有项目，并可以选择性地与创建动作配对，如果搜索未返回结果则添加新项目。

搜索动作让用户能够更充分利用已添加到其应用中的数据，例如避免添加重复项目或查找项目信息（如天气、转换或联系人信息），以在后续步骤中使用。

大多数有用的搜索动作会返回一个单独的项目，该项目可能需要在另一个 Zap 步骤中使用。

搜索动作的返回输出应是一个 JSON 格式的数组，按最佳匹配排序。只返回第一个项目。如果未找到匹配项，必须返回一个带有空数组的 200 响应。如果您的 API 对于无结果的搜索返回 404 错误，请在 API 调用中添加自定义代码，将其替换为空数组。

3. 删除动作

Zapier 建议仔细考虑那些完全删除或移除数据的动作步骤。为了防止数据丢失，动作步骤应仅添加或更新数据。

如果您正在考虑为您的应用添加删除动作，请考虑使用替代动作，例如停用、退订或取消项目，而不是完全删除项目。

如果您确实添加了删除动作，请确保包含一个确认字段，以向用户明确说明一旦 API 请求发出，该动作是不可逆的。

需要帮助？告诉我们您的问题，我们将为您连接合适的资源或联系支持。